RTM PWN GUARD UNTER WINDOWS - WSL2-BRÜCKE FÜR DEN PWNAGOTCHI-RADAR
====================================================================
Stand: 23. Juli 2026

WARUM EINE BRÜCKE NÖTIG IST
--------------------------------------------------------------------
Der Pwnagotchi-Radar-Sensor benötigt den WLAN-"Monitor-Mode" sowie
rohe 802.11-Frames (Linux-Kernel-Funktionen "iw"/nl80211 und
AF_PACKET-Rohsockets). Diese Funktionen existieren unter Windows
nicht in vergleichbarer Form - ein nativer Windows-Port ist daher
technisch nicht seriös möglich.

Die einzige zuverlässige Lösung: Der ECHTE, unveränderte Linux-Sensor
läuft in einer echten Linux-Umgebung (WSL2 = Windows Subsystem for
Linux 2, ein vollständiger Linux-Kernel unter Windows), und ein
externer USB-WLAN-Stick wird direkt an diese Linux-Umgebung
durchgereicht (USB/IP-Passthrough). Der eingebaute WLAN-Chip des
Windows-Rechners kann NICHT durchgereicht werden - es wird zwingend
ein externer USB-WLAN-Adapter benötigt.

VORAUSSETZUNGEN
--------------------------------------------------------------------
1. Windows 10 (Version 2004+) oder Windows 11, 64-Bit.
2. Ein externer USB-WLAN-Adapter, dessen Chipsatz unter Linux
   Monitor-Mode unterstützt. Bekannte, gut unterstützte Chipsätze:
     - Atheros AR9271 (z. B. TP-Link TL-WN722N v1)
     - Ralink/MediaTek RT3070 / MT7612U
     - Realtek RTL8812AU (mit passendem Treiber)
   WICHTIG: Nicht jeder USB-WLAN-Stick unterstützt Monitor-Mode.
   Vor dem Kauf/Einsatz die Chipsatz-Kompatibilität mit Linux
   Monitor-Mode prüfen.
3. Administratorrechte auf dem Windows-Rechner.
4. Internetverbindung für die einmalige Einrichtung.

EINRICHTUNG - EINMALIG
--------------------------------------------------------------------
Schritt 1: WSL2 installieren (PowerShell als Administrator):
    wsl --install -d Ubuntu

Schritt 2: Nach Neustart Ubuntu-Ersteinrichtung abschließen
    (Benutzername/Passwort vergeben).

Schritt 3: usbipd-win auf dem WINDOWS-Host installieren
    (PowerShell als Administrator):
    winget install usbipd

    Alternativ kann das beiliegende Skript
    "setup-windows-host.ps1" ausgeführt werden.

Schritt 4: In der WSL2/Ubuntu-Umgebung die Sensor-Abhängigkeiten
    installieren. Dazu das beiliegende Skript
    "setup-wsl2-sensor.sh" in WSL2 ausführen:
    bash setup-wsl2-sensor.sh

    Dieses Skript installiert: python3, python3-pip, iw,
    usbutils, linux-tools-generic (usbip-Client) sowie die
    Python-Abhängigkeiten des Sensors.

EINRICHTUNG - JEDES MAL VOR DER NUTZUNG
--------------------------------------------------------------------
Schritt 1: USB-WLAN-Stick einstecken.

Schritt 2: In PowerShell (als Administrator) auf dem Windows-Host
    die Busid des Sticks ermitteln und an WSL2 anbinden:
    usbipd list
    usbipd bind --busid <BUSID>
    usbipd attach --wsl --busid <BUSID>

    Diese drei Befehle übernimmt auch das beiliegende Skript
    "attach-wlan-adapter.ps1" (Busid als Parameter übergeben).

Schritt 3: In WSL2 prüfen, ob der Adapter angekommen ist:
    lsusb
    iw dev

Schritt 4: Den Sensor wie unter Linux gewohnt starten, z. B.:
    cd addons/RTM-Pwn-Guard/sensor
    sudo python3 rtm_pwn_sensor.py --interface <WLAN-INTERFACENAME>

    Die grafische RTM-Suite-Light-Anwendung läuft weiterhin ganz
    normal direkt unter Windows; nur der WLAN-Sensor-Prozess läuft
    in WSL2. Die Kommunikation zwischen beiden erfolgt über die im
    Sensor vorgesehene lokale Schnittstelle (siehe README.txt im
    sensor-Ordner).

BEKANNTE EINSCHRÄNKUNGEN
--------------------------------------------------------------------
- Eingebaute Laptop-WLAN-Chips können nicht durchgereicht werden;
  es wird zwingend ein externer USB-Adapter benötigt.
- Nicht jeder USB-WLAN-Chipsatz unterstützt Monitor-Mode unter Linux.
- USB/IP-Passthrough kann sich bei manchen USB-3.0-Controllern
  instabil verhalten; USB 2.0-Anschluss/Hub kann helfen.
- Diese Brücke wurde vorbereitet, aber auf einem echten
  Windows-Rechner mit passendem USB-WLAN-Stick noch nicht
  durch den Ersteller verifiziert. Bitte vor Einsatz in der Praxis
  selbst testen.

RECHTLICHER HINWEIS
--------------------------------------------------------------------
Es gelten unverändert die EULA, die Haftungsbegrenzung und die
Datenschutzhinweise von RTM Suite Light / RTM Pwn Guard. Der passive
WLAN-Radar darf ausschließlich für eigene, rechtmäßig genutzte
Netzwerke oder mit ausdrücklicher Berechtigung eingesetzt werden.
